Scripting using S-Lang

Sam Spade has limited support for running scripts, using an embedded version of S-Lang, an interpreted language similar to C.

S-Lang command can be executed directly from the S-Lang command... option of the Tools menu or by hitting the space bar from the S-Lang console window

Basic S-Lang

S-Lang is a general purpose language, with a number of extensions for scripting interactive programs. It usually provides more flexibility than is used here. Better examples of S-Lang use are the jed text editor or the slrn scoring newsreader

A Guide to the S-Lang Language

S-Lang Run-Time Library Reference

Extensions

int MessageBox(string title, string message, int style)

Display a windows message box. style is passed directly to the Win32 MessageBox call

void ss_ping(string target, int count)

Open a ping window

void ss_whois(string query, string server)

Open a whois window

void ss_finger(string user, string host)

Open a finger window

void ss_dns(string query)

Open a dns window

void ss_dig(string query, string server)

Open an advanced dns window

void ss_vrfy(string user, string host)

Open an SMTP verify window

void ss_time(string host)

Open a time window

void ss_fasttrace(string host)

Open a fast traceroute window

void ss_slowtrace(string host)

Open a slow traceroute window

string ss_getinput()

Fetch the string in the address bar

string ss_getnameserver()

Fetch the current nameserver

void ss_addparagraph(string email_address, string tag, string message)

Add a paragraph at the top of the email message being composed. It will be prefixed by tag followed by two colons, or added to the paragraph already containing that tag if it exists. Also the email address will be appended to the To: field of the email message

string ss_abusenet(string domain)

Return the abuse desk email address or addresses for the given domain. If an address is filed at abuse.net it will be returned, otherwise a reasonable guess will be returned

void ss_write(string)

Write a string to the script console

void ss_error(string)

Write a string to the script console, highlighted as an error.

S-Lang functions defined in the startup file

If the following functions are defined in the startup file (usually startup.sl) then they may be called from within the program

ss_mac_default()

Called when the Go (arrow) button on the address bar is pressed, or enter is typed into the address bar

ss_mac_f2
ss_mac_f3
ss_mac_f4
ss_mac_f5
ss_mac_f6
ss_mac_f7
ss_mac_f8
ss_mac_f9
ss_mac_f11
ss_mac_f12

Called when the appropriate function key is pressed

ss_ab_clickthrough(string domain, string address)
ss_ab_dialup(string domain, string address)
ss_ab_dns(string domain, string address)
ss_ab_dropbox(string domain, string address)
ss_ab_misc(string domain, string address)
ss_ab_relay(string domain, string address)
ss_ab_this(string domain, string address)
ss_ab_webhost(string domain, string address)

Called when one of the abuse options is called from the context menu